Summary

Add a local, OpenAPI-driven Stripe list server (@stripe/sync-test-utils) so tests no longer depend on the remote rate-limited Stripe API. The server runs in-process against Postgres, implements list/retrieve for every endpoint discovered from the spec, and supports auth guards and fault injection.

Building the test infrastructure uncovered and fixed bugs in the production code.

Bug fixes

• Unsupported query params sent to all endpoints — limit, starting_after, and ending_before were sent to every endpoint regardless of whether the OpenAPI spec advertises them (e.g. reporting_report_types), causing 400 errors. Added buildSpecAwareListFn that filters params based on the spec.
• Pagination on non-paginating endpoints — has_more was trusted and starting_after was sent even for endpoints that don't support forward pagination, potentially causing infinite loops or data loss. Added supportsForwardPagination flag derived from the spec.
• v2 created filters ignored — the source hardcoded supportsCreatedFilter: false for all v2 endpoints even when the spec declares created, skipping time-range filtering during segmented backfill.
• v2 list functions didn't send created query params — buildListFn in listFnResolver.ts never wired params.created into v2 request URLs. Now encodes created[gte]/created[lt] with ISO timestamp conversion.
• Non-OK API responses silently swallowed — buildListFn and buildRetrieveFn called response.json() without checking response.ok. A 401 or 500 was parsed as if it were valid data. Added assertOk + StripeApiRequestError to throw explicitly.
• No retry on transient Stripe API errors — getAccount, list, and retrieve calls had no retry logic. A single transient 500 from Stripe would fail the entire setup/sync. Added withHttpRetry (exponential backoff, retries on 429/5xx/network errors).
• Sync errors silenced — service workflows marked pipelines as ready even when the sync had permanent errors. Added classifySyncErrors to distinguish transient vs permanent failures, with proper error propagation in the Temporal workflow.
• Unhandled Postgres pool errors — destination-postgres pool errors could crash the process. Added pool.on('error', ...) handler.

New package: @stripe/sync-test-utils

OpenAPI-driven local Stripe list/retrieve server backed by Postgres:

• Discovers endpoints from the spec, creates tables, seeds with schema-generated fixtures
• V1 and V2 list semantics (pagination, created filters, has_more / next_page_url)
• Auth guards, fault injection hooks, optional OpenAPI query param validation
• Docker Postgres helper for isolated test databases

New tests

• test-server-all-api — syncs every stream for every supported API version (2020+) through the real engine against the local test server
• test-server-sync — engine-level sync and state checkpoint tests: segmented backfill, boundary conditions, pagination, resume, empty segments, multi-stream, v2 cursor streams
• test-sync-engine — failure mode coverage: bad API key, auth errors on individual streams, transient 500s with retry
• test-e2e-network — network disruption and fault injection: pauses Stripe/Postgres/Temporal containers mid-sync, injects auth failures and transient 500s, validates recovery and error propagation through the full service stack
• Unit tests — resourceRegistry, client retry behavior, listFnResolver pagination flags and error propagation, index source setup/backfill flows

Other changes

• Docker / CI hygiene: containers auto-remove, volumes clean up on exit
• New e2e compose overlay (compose.e2e.yml)
• OpenAPI object generator (objectGenerator.ts) for schema-based test fixture generation